I am taking a moment to recalibrate my chess board for the OpenAPI community, and there is no better way for me to accomplish this than to write a story here on the blog. I have several folks I am working with to help move the OAS conversation forward as part of official OAI efforts, but also as part of Postman Open Technologies, and having a map of the landscape loaded up into my head and easily referenced as part of conversations helps me move things forward.
As of November 22nd, 2021, here are all the moving parts of the OpenAPI discussion for me, organized as a simple narrative focused on moving the community forward:
I do not want to assume everyone knows what OpenAPI is, and here are the links you should tune into if you are looking to learn more about this important API specification:
These are the basics of where you can learn about what OpenAPI is, and how you can put it to work, then stay in tune with the community via stories on the blog and conversations on Twitter.
If you are wanting to do more than just learn what is happening I recommend using these resources to quickly understand what is happening and get more involved at the technical level.
You can find everything you need to keep up speed on what is happening with the spec from a technical point of view using these links, and contribute to the conversation and overall road map.
There are two core meeting that you can tune into to get a handle on the technical or the business side of the OpenAPI community.
You don't have to be a member to join into these conversations and I highly recommend you look at joining the discussion, even it if is just about listening and learning.
In addition to working on the core spec you can get involved in one of the latest special interest groups (SIG) that have emerged this year, moving forward extensions of the spec and how it is used in a variety of sectors.
These groups provide additional ways in which we can move the OpenAPI specification forward by better defining extensions, and being more organized around how the specification is applied within a specific industry.
There are a number of projects being moved forward within the OpenAPI community, working to provide a way we can collectively move projects forward through paid contractors and volunteer work.
We have two projects to help move drive new members and ensure that the OAI is best serving it’s membership, helping grow the community.
Membership is essential to the OAI continuing to meet it’s mission, and you can check out the existing members on the website, and please consider joining to help support this important work.
The OAI avoids showcasing specific API service providers, but identifying, profiling, and engaging with API Providers and open source tooling provides is an important part of this community.
API producers adopting OAS, and showcasing their usage is an important part of how the community works. Open Source tooling is also a critical ingredient in how the specification is making an impact across the providers. I believe strongly that extensions are key to understanding the road map for the specification beyond the core meetings.
There are many ways in which we are trying to help amplify what is happening within the OAS community, and these are a few of the projects that exist to help drive things forward.
The marketing committee leads the discussion around marketing activities, and there are many other marketing projects and stories emerging out of SIGs, the TDC, and other parts, but these reflect some core areas we are investing in marketing.
There is always more work to be done, but I feel that this overview provides a healthy snapshot of where things are within the OpenAPI community. There are other projects with AsyncAPI, JSON Schema, and around automated OpenAPI discovery I’d like to see happen alongside all of this, but for the purposes of this post, and the conversations I am having today, this reflects my priorities in this moment. I have put a lot of thought into the marketing engine represented across all of these project areas, and if done well, we have the opportunity to not just showcase the existing things happening within the OpenAPI community, but help grow and expand the community.
I have just on-boarded three contractors who I am dubbing "the OAI Community Advocates" to help on some of this work, but the OAI desperately needs folks to step up in all of the areas represented above. If you are more technical feel free to jump in with one of the SIGs or help drive the TDC conversation. If you aren’t technical, we’d love to et you involved in any of the marketing activities listed above. Really, there is something for everyone represented above, so if you have the time, we’d love to have you dive in and help wherever you can. Feel free to email me if you have any questions, jump in on Github, or join the OAI Slack channel. The community is really interested in getting new folks involved and helping out, working to showcase the great stuff occurring across the space, and we need your help to do that!